package com.minimalist.common.feign.client.lindi;

import com.minimalist.common.config.mybatis.bo.PageResp;
import com.minimalist.common.entity.lindi.vo.subsidyapplicationpaynotice.LindiSubsidyApplicationPayNoticeQueryVO;
import com.minimalist.common.entity.lindi.vo.subsidyapplicationpaynotice.LindiSubsidyApplicationPayNoticeVO;
import com.minimalist.common.feign.config.FeignConfig;
import com.minimalist.common.feign.fallback.lindi.LindiSubsidyApplicationPayNoticeFeignClientFallbackFactory;
import com.minimalist.common.response.R;
import com.minimalist.common.utils.Add;
import com.minimalist.common.utils.Update;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import jakarta.validation.constraints.NotNull;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

import java.util.List;


/**
 * 林地指标交易平台_补贴申请支付通知Feign客户端
 *
 * @author 11987
 */
@FeignClient(name = "minimalist-lindi"
        , contextId = "lindiSubsidyApplicationPayNoticeFeignClient"
        , path = "/minimalist/lindi/subsidyApplicationPayNotice"
        , configuration = FeignConfig.class
        , fallbackFactory = LindiSubsidyApplicationPayNoticeFeignClientFallbackFactory.class)
public interface LindiSubsidyApplicationPayNoticeFeignClient{

    /**
     * 添加补贴申请支付通知
     *
     * @param subsidyApplicationPayNoticeVO 补贴申请支付通知信息对象，包含支付通知的详细信息
     * @return 操作结果，成功返回成功信息，失败返回错误信息
     * @author 11987
     * @since 1.0.0
     */
    @PostMapping("/addSubsidyApplicationPayNotice")
    @Operation(summary = "添加补贴申请支付通知")
    R<?> addSubsidyApplicationPayNotice(
            @RequestBody @Validated(Add.class)
            LindiSubsidyApplicationPayNoticeVO subsidyApplicationPayNoticeVO);

    /**
     * 根据补贴申请支付通知ID删除补贴申请支付通知
     *
     * @param subsidyApplicationPayNoticeId 补贴申请支付通知ID，不能为空
     * @return 操作结果，成功返回成功信息，失败返回错误信息
     * @author 11987
     * @since 1.0.0
     */
    @DeleteMapping("/deleteSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId")
    @Operation(summary = "删除补贴申请支付通知 -> 根据补贴申请支付通知ID删除")
    R<?> deleteSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId(
            @RequestParam("subsidyApplicationPayNoticeId")
            @NotNull(message = "补贴申请支付通知ID不能为空")
            @Parameter(name = "subsidyApplicationPayNoticeId", required = true, description = "补贴申请支付通知ID")
            Long subsidyApplicationPayNoticeId);

    /**
     * 根据补贴申请支付通知ID修改补贴申请支付通知信息
     *
     * @param subsidyApplicationPayNoticeVO 补贴申请支付通知信息对象，包含需要更新的支付通知信息
     * @return 操作结果，成功返回成功信息，失败返回错误信息
     * @author 11987
     * @since 1.0.0
     */
    @PutMapping("/updateSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId")
    @Operation(summary = "修改补贴申请支付通知")
    R<?> updateSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId(
            @RequestBody @Validated(Update.class)
            LindiSubsidyApplicationPayNoticeVO subsidyApplicationPayNoticeVO);

    /**
     * 分页查询补贴申请支付通知列表
     *
     * @param queryVO 查询条件对象，包含分页参数和筛选条件
     * @return 分页结果，包含补贴申请支付通知列表和分页信息
     * @author 11987
     * @since 1.0.0
     */
    @GetMapping("/getPageSubsidyApplicationPayNoticeList")
    @Operation(summary = "查询补贴申请支付通知列表(分页)")
    R<PageResp<LindiSubsidyApplicationPayNoticeVO>> getPageSubsidyApplicationPayNoticeList(LindiSubsidyApplicationPayNoticeQueryVO queryVO);

    /**
     * 根据补贴申请支付通知ID查询补贴申请支付通知详细信息
     *
     * @param subsidyApplicationPayNoticeId 补贴申请支付通知ID，不能为空
     * @return 补贴申请支付通知详细信息，如果不存在则返回空
     * @author 11987
     * @since 1.0.0
     */
    @GetMapping("/getSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId/{subsidyApplicationPayNoticeId}")
    @Operation(summary = "根据补贴申请支付通知ID查询补贴申请支付通知")
    R<LindiSubsidyApplicationPayNoticeVO> getSubsidyApplicationPayNoticeBySubsidyApplicationPayNoticeId(
            @PathVariable(value = "subsidyApplicationPayNoticeId")
            @NotNull(message = "补贴申请支付通知ID不能为空")
            @Parameter(name = "subsidyApplicationPayNoticeId", description = "补贴申请支付通知ID", required = true)
            Long subsidyApplicationPayNoticeId);

    /**
     * 根据补贴申请ID查询支付通知列表
     *
     * @param subsidyApplicationId 补贴申请ID，不能为空
     * @return 支付通知列表，如果没有支付通知则返回空列表
     * @author 11987
     * @since 1.0.0
     */
    @GetMapping("/getSubsidyApplicationPayNoticeListBySubsidyApplicationId/{subsidyApplicationId}")
    @Operation(summary = "根据补贴申请ID查询支付通知列表")
    R<List<LindiSubsidyApplicationPayNoticeVO>> getSubsidyApplicationPayNoticeListBySubsidyApplicationId(
            @PathVariable(value = "subsidyApplicationId")
            @NotNull(message = "补贴申请ID不能为空")
            @Parameter(name = "subsidyApplicationId", description = "补贴申请ID", required = true)
            Long subsidyApplicationId);
}